package cn.tedu.user.management.service;

import cn.tedu.rtms.commons.pojo.vo.PageData;
import cn.tedu.user.management.pojo.param.SectionAddNewParam;
import cn.tedu.user.management.pojo.param.SectionUpdateInfoParam;
import cn.tedu.user.management.pojo.vo.SectionListItemVO;
import cn.tedu.user.management.pojo.vo.SectionStandardVO;
import cn.tedu.user.management.pojo.vo.SectionTreeItemVO;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * 处理部门数据的业务接口
 *
 * @author java@tedu.cn
 * @version 0.0.1
 */
@Transactional
public interface ISectionService {

     /**
     * 添加部门
     *
     * @param sectionAddNewParam 部门数据
     */
    void addNew(SectionAddNewParam sectionAddNewParam);

    /**
     * 删除部门
     *
     * @param id 部门ID
     */
    void delete(Long id);

     /**
     * 查询部门列表，将使用默认的每页记录数
     *
     * @param pageNum 页码
     * @return 部门列表
     */
    PageData<SectionListItemVO> list(Integer pageNum);

    /**
     * 查询部门列表
     *
     * @param pageNum  页码
     * @param pageSize 每页记录数
     * @return 部门列表
     */
    PageData<SectionListItemVO> list(Integer pageNum, Integer pageSize);

    /**
     * 查询部门名称列表
     *
     * @return 部门名称列表(不分页)
     */
    List<SectionListItemVO> list();

    /**
     * 查询子级部门名称列表
     *
     * @return 子级部门名称列表(不分页)
     */
    List<SectionListItemVO> list(Long parentId);


    /**
     * 查询部门名称列表
     *
     */
    List<SectionTreeItemVO> listTree();

    /**
     * 查询招聘部门名称列表
     *
     */
    List<SectionTreeItemVO> listEnableTree();

    /**
     * 修改员工信息
     *
     * @param id               被修改员工的ID
     * @param sectionUpdateInfoParam 的部门新数据
     */
    void updateInfoById(Long id, SectionUpdateInfoParam sectionUpdateInfoParam);

    /**
     * 根据ID查询员工信息
     *
     * @param id 员工ID
     * @return 匹配的员工数据，如果没有匹配的数据，则返回null
     */
    SectionStandardVO getStandardById(Long id);

}
